The following diagram displays the various transit states that a unit may have:
A transit state identifies a unit as:
Advised: Is incoming but not certain to arrive, such as a unit created via a release EDI message.
Inbound: Is incoming and located on an inbound carrier, such as a pre-advised unit or a unit created via a stowplan EDI message.
EC/In: Is incoming and at the facility. For example, a unit that is in a queue and waiting for the equipment control in XPS to place it in the yard.
Yard: Is in a specific position in a yard in a facility.
N4 records the Time In for a unit when it enters the Yard transit state.
EC/Out: Is in a queue at a facility and waiting for the equipment control in XPS to deliver it. N4 uses this transit state only for units that need to go out the Gate.
Loaded: Is loaded on an outbound carrier.
Departed: Departed on an outbound carrier.
N4 records the Time Out for a unit when it enters the Departed transit state.
Retired: Is in a special state to indicate that the unit visit life cycle ended at the facility.
For example, if you attach or bundle a unit to another primary unit, N4 retires the attached unit.
The Inbound, EC/In, Yard, EC/Out, and Loaded transit states are sub-states of the Active visit state. Therefore, while in these states, a unit is visible in XPS.
TImestamps
There are several timestamps associated with unit facility visit transit states. Each timestamp is saved for information purposes only.
Field |
Description |
---|---|
ufvCreateTime |
Creation time of the UFV entity |
ufvTimeOfLastMove |
Time of the unit move to its current position. For a new UFV, this is the same as the ufvCreateTime. |
ufvTimeOfLoading |
Time of placement of the unit onto its outbound carrier. |
ufvTimeEcIn |
Time when transit state became EC/IN.
|
ufvTimeEcOut |
Time when transit state became EC/OUT. |
ufvTimeIn |
Time when transit state became YARD. |
ufvTimeOut |
Time when transit state became DEPARTED. |
ufvDivTimeAppntmnt |
Time of delivery appointment. |
ufvTimeInventory |
Time when yard position last verified. |
ufvTimeComplete |
Time when transit state became DEPARTED or RETIRED. The end of the unit facility visit lifecycle. |
Service Events
There are four primary service events recorded for transit state transitions, some of which allow you to begin using additional unit events:
In events: When the unit's inbound carrier transitions to the ARRIVED visit state (on page 1) and the transit state changes to INBOUND. The three specific in events are:
UNIT_IN_VESSEL
UNIT_IN_GATE (external ID: IN_GATE_CONTAINER)
UNIT_IN_RAIL
Off events: Placement of the unit into the yard.
UNIT_DISCHARGE
UNIT_DELIVER
UNIT_DERAMP
On Events: Placement of the unit onto its outbound carrier.
UNIT_LOAD
UNIT_DELIVER
UNIT_RAMP
Out events: When both the transit state and the unit's outbound carrier transition to DEPARTED.
UNIT_OUT_VESSEL
UNIT_OUT_GATE (external ID: OUT_GATE_CONTAINER)
UNIT_OUT_RAIL